package com.demandbreakdown.xiyun.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.demandbreakdown.xiyun.model.dto.auth.ResetPasswordDTO;
import com.demandbreakdown.xiyun.model.dto.user.UserQueryDTO;
import com.demandbreakdown.xiyun.model.dto.user.UserStatusUpdateDTO;
import com.demandbreakdown.xiyun.model.dto.user.UserUpdateDTO;
import com.demandbreakdown.xiyun.model.entity.User;
import com.demandbreakdown.xiyun.model.vo.common.PageVO;
import com.demandbreakdown.xiyun.model.vo.user.UserVO;

/**
 * 用户服务接口
 *
 * @author poxz
 */
public interface UserService extends IService<User> {

    /**
     * 获取当前登录用户信息
     *
     * @return UserVO
     */
    UserVO getCurrentUser();

    /**
     * 根据用户ID获取用户信息（管理员权限）
     *
     * @param userId 用户ID
     * @return UserVO
     */
    UserVO getUserById(Long userId);

    /**
     * 更新用户个人资料
     *
     * @param userId        用户ID
     * @param userUpdateDTO 用户更新参数
     * @return UserVO
     */
    UserVO updateProfile(Long userId, UserUpdateDTO userUpdateDTO);

    /**
     * 重置用户密码
     *
     * @param userId           用户ID
     * @param resetPasswordDTO 密码重置参数
     */
    void resetPassword(Long userId, ResetPasswordDTO resetPasswordDTO);

    /**
     * 分页查询用户列表（管理员权限）
     *
     * @param userQueryDTO 用户查询参数
     * @return PageVO
     */
    PageVO<UserVO> getUsers(UserQueryDTO userQueryDTO);

    /**
     * 更新用户状态（管理员权限）
     *
     * @param userId              用户ID
     * @param userStatusUpdateDTO 用户状态更新参数
     */
    void updateUserStatus(Long userId, UserStatusUpdateDTO userStatusUpdateDTO);
}
